home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / door / tccb109.zip / TCCB.DOC < prev    next >
Text File  |  1991-12-13  |  38KB  |  937 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                              - T C C B -
  30.  
  31.                               Ver 1.08
  32.  
  33.                                  by
  34.  
  35.                            Paul Michaelson
  36.                                   &
  37.                              Bruce Pinto
  38.  
  39.                           December 08, 1991
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.     TCCB (C) 1991 a BBS Call Back Registration Program Version 1.08
  78.                              Users Manual
  79.                   By Paul Michaelson 12-08-91 07:35pm
  80.  
  81.  
  82.  
  83.  
  84.      TCCB is a copyrighted software product designed by Paul Michaelson 
  85. and written by Paul Michaelson and Bruce Pinto.  TCCB or any part of 
  86. the TCCB distribution package may not be distributed in any fashion 
  87. without prior written permission from the authors. TCCB is NOT in the 
  88. public domain.
  89.  
  90.      Limited license is granted to distribute the SHAREWARE version of
  91. TCCB.  SYSOPS:  You may include the shareware version of TCCB in your
  92. file directories for downloading to the general public.  Shareware
  93. distributors may distribute the Shareware versions of TCCB as long as
  94. the program is NOT sold.  A small charge may be made to recover media
  95. costs only.  Registered copies of TCCB may not be distributed for any
  96. reason. You may use the unregistered version of TCCB for 30 days to
  97. evaluate the program. After 30 days from the time you started using
  98. TCCB you must register it, or stop using it.
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.                       Where to get a copy of TCCB
  107.                       ---------------------------
  108.  
  109.  
  110.  
  111.  
  112.  
  113.      The main distribution sites for TCCB are the authors BBS in
  114.      northern Virginia, and the main beta test site in Rome New York.
  115.      These system are:
  116.  
  117.  
  118.          Author's BBS:                  Main BETA test site:
  119.        Frostbyte Falls BBS            Ulysses Systems Network
  120.      SysOp: Paul Michaelson             SysOp: Joseph Aquino
  121.        Phone 703-425-6640    BBS Node #1 - (315) 339-5591 HST v.32b v.42b
  122.         24 Hrs. 3/12/24         Node #2 - (315) 339-5595 HST v.42b
  123.                              File requests honored 24-Hrs other than NMH
  124.                                      RBBSNET: 8:954/401 & 8:954/402
  125.                                      FIDONET: 1:260/501 & 1:260/502
  126.                                      EGGNET:  99:9226/501
  127.                                Use MAGIC File Name: TCCB for the latest
  128.                                version of the "TCCB" Callback door.
  129.  
  130.  
  131.  
  132.  
  133.  
  134.                         Disclaimer of Warranty
  135.                         ----------------------
  136.  
  137.  
  138.  
  139.      No warranty of any kind is offered with TCCB either stated or
  140. implied.  You must use the program at your own risk.  TCCB (including
  141. the instructions for it's use) is provided "AS IS" without warranty of
  142. any kind. The authors of TCCB do not warrant, guarantee, or make ANY
  143. representations regarding the use, or results of the use, of TCCB or
  144. any written materials concerning TCCB in terms of correctness,
  145. accuracy, reliability or otherwise.  THE ENTIRE RISK AS TO THE RESULTS
  146. AND PERFORMANCE OF TCCB IS ASSUMED BY YOU AND NOT THE AUTHORS OF TCCB.
  147. If TCCB or it's written materials are defective, YOU, and not the
  148. authors of TCCB, assume the entire cost of all necessary servicing,
  149. repair, or correction.
  150.  
  151.      Neither Paul Michaelson or Bruce Pinto (the authors of TCCB) shall
  152. be liable for any special, direct, indirect, consequential or
  153. incidental damages (including damages for loss of business profits,
  154. business interruption, loss of business information, and the like)
  155. arising out of the use or inability to use TCCB even if the authors
  156. have been advised of the possibility of such damages.
  157.  
  158.  
  159.  
  160.                           Registering TCCB
  161.                           ----------------
  162.  
  163.  
  164.  
  165.      TCCB is free to any RBBS system that does not charge for access.
  166. If you run an RBBS and charge for access you must register the program
  167. and pay for it. A BBS that charges for access is defined as:  Any BBS
  168. that receives payment for access to features (including more connection
  169. time) that are not available to non paying users. It does NOT matter if
  170. this payment is called a donation. If your users have to pay or make a
  171. donation to get access to features that are not available to non paying
  172. (donating) users then you are NOT running a free BBS.  If you run an
  173. RBBS that does NOT charge for access then you may use the program free
  174. of charge but you still must register it.  Donations will be accepted
  175. in fact we are depending on them. If you are going to use the program
  176. for free on a free RBBS then please consider a donation.  Your donation
  177. will make it possible for us to support this program and write new hi
  178. performance C based programs for RBBS and other BBSs.  A registration
  179. form is included with the program.  Fill out the registration form and
  180. mail it to the address printed at the top of the form.  If you are
  181. paying to register TCCB or sending a donation you must send a check or
  182. money order payable to "Paul Michaelson".  If you register TCCB as a
  183. free RBBS and at some time after registering begin to charge for access
  184. you must cease to use the program or register again and pay for it.
  185. Upon receipt of your completed registration form we will either send
  186. you a registered copy of the program on disk (for paid registrations
  187. only) or set up an account for you on Frostbyte Falls BBS the home of
  188. TCCB. Accounts on FFBBS for free registrations require a three week
  189. waiting period to set up. This allows us time to verify the information
  190. you provided on the registration form. The authors reserve the right
  191. to deny free registration to any BBS that we determine to not fit
  192. the definition of a free access BBS. All decisions are final. Once
  193. your FFBBS account has been set up, you will be allowed to download
  194. your registered copy of the program from FFBBS.  If you are sending in
  195. a free registration, make sure to include the password you wish to use
  196. on FFBBS. Future upgrades of TCCB for RBBS are free to registered
  197. users.  Registering SysOps receive full visiting SysOp privileges on
  198. FFBBS as well as access to the TCCB conference.
  199.  
  200. NOTICE: The authors of TCCB reserve the right to abolish free
  201. registrations, and revoke existing free registrations at any time. We
  202. are hoping enough people will make donations to allow us to maintain
  203. the program.  If enough people make donations, we will continue to
  204. allow free registrations. If very few people donate, we will be forced
  205. to revoke free registrations, and charge everyone for the license to
  206. use TCCB.  PLEASE HELP TO SUPPORT FREE RBBS SYSTEMS AND DONATE WHAT YOU
  207. CAN. EVEN A SMALL DONATION WILL GO A LONG WAY!
  208.  
  209.  
  210.  
  211.  
  212.  
  213.                               Description
  214.                               -----------
  215.  
  216.  
  217.  
  218.      TCCB is a program designed to run under a BBS and provide a way of
  219. verifying the identity of new callers.  TCCB is designed to run under
  220. RBBS. Some of TCCB's features are:
  221.  
  222.      -    Sets user level after successful verification to level set by
  223.           the SysOp. The door can be configured to increase or decrease
  224.           the security level, or set it to a specific level. In fact
  225.           with the security level configuration file you can specify
  226.           that a user with any security level be set to a specified
  227.           security level if he/she is verified by the door, or another
  228.           level if the verification process fails!
  229.  
  230.      -    Will "SKIP" callback on user depending on users security
  231.           level.  The sysop can define a range of security levels to be
  232.           verified. The door will "SKIP" (just return to the BBS) users
  233.           with security levels higher than the upper limit of this
  234.           range.
  235.  
  236.      -    Handles long distance calls. Configurable to callback or skip
  237.           long distance callers.  Area Code configuration file permits
  238.           callback of selected area codes only at predefined times! You
  239.           can even allow a user to continue on the BBS or hangup after
  240.           he/she has been verified on a long distance callback.
  241.  
  242.      -    Local exchanges that require area codes to be sent are
  243.           supported.
  244.  
  245.      -    Fully logs each call with two log files. Optionally sends
  246.           main log to printer.
  247.  
  248.      -    Checks the users phone number against the log of verified
  249.           phone numbers to prevent multiple registrations.
  250.  
  251.      -    Works great on RBBSs with multiple nodes. All possible nodes
  252.           are fully supported.
  253.  
  254.      -    Instructions printed to user are simple text files allowing
  255.           SysOps to easily modify and customize them.  Make the door
  256.           look any way you like!
  257.  
  258.      -    Supports ANSI graphics. One set of files for standard ASCII
  259.           output and another set of files for ANSI output.
  260.  
  261.      -    Automatically detects users graphics setting and prints the
  262.           appropriate text or ANSI graphics files.
  263.  
  264.      -    Supports Fossil Drivers.
  265.  
  266.      -    Supports 16550's with fifoed I/O.
  267.  
  268.      -    Serial I/O tested at speeds in excess of 115k baud.
  269.  
  270.      -    Desqview and network (LAN) compatable.
  271.  
  272.      -    Written in Borland Turbo C 2.0.
  273.  
  274.      -    Support available via author's RBBS for registered users.
  275.  
  276.      -    Free to RBBSs that do not charge for access or services.
  277.  
  278.      -    Register only once.  No cost re-registration for new
  279.           RBBS versions (for payed registrations only).
  280.  
  281.      -    User friendly with simple instructions and no random numbers
  282.           to write down and type in 4 or 5 times.  The program simply
  283.           asks the user to type his name to verify a connection.
  284.  
  285.      -    SAFE to use. Requires only the DORINFO[node#].DEF file to
  286.           operate.  Poses no danger to your main users file because
  287.           it does NOT access it.
  288.  
  289.  
  290.  
  291.  
  292.  
  293.                             INSTALLING TCCB
  294.                             ---------------
  295.  
  296.  
  297.  
  298.     To install TCCB unpack the distribution compressed file into your
  299. RBBS main directory. This is the same directory you have the RBBS-
  300. PC.EXE file in. Next create the BATCH file called by RBBS to run the
  301. program.
  302.  
  303.   NOTE:  A program that will build a batch file for you automatically,
  304. "INSTALL.COM", is included in the distribution package.  The INSTALL
  305. program is described later in this text.
  306.  
  307.     TCCB is a standard RBBS door program, and interfaces to the BBS in
  308. the same fashion as any door program.  You must supply the complete
  309. path and filename of the RBBS DORINFO[node#].DEF and DOUT[node#].DEF
  310. files.  You must supply the port information to tell the door which
  311. communications port to use.  Except for the security level, and area
  312. code info, all configuration information is contained in the batch file
  313. that invokes CB.EXE (the TCCB executable).  The configuration
  314. information is simply passed to TCCB as command line parameters when
  315. the door is executed.  This makes TCCB highly configurable. In fact on
  316. a multinode system the door can be easily configured to use different
  317. configurations for each node! An example batch file is shown below.
  318.  
  319.      cb c:\rbbs\dorinfo1.def 5 02f8:3 c:\rbbs\dout1.def <continued>
  320.      ATZ ATX4V1Q0 ATDT BUSY "CONNECT" " " 10
  321.                         <This is all one line>
  322.  
  323.      The batch file requires just one line.  The line consists of the
  324. command to execute CB.EXE (the door program itself) and eleven or
  325. twelve parameters. The parameters must be in the order shown and they
  326. MUST be separated by spaces.  They are:
  327.  
  328.      NOTE: Some of these parameters are shown with double quotes. The
  329.      use of double quotes is only necessary if the parameter contains
  330.      spaces.
  331.  
  332.      1.   The complete path and filename including node
  333.           number of the RBBS DORINFO[node#].DEF file.  For multi node
  334.           use make one batch file for each node. Make sure to set the
  335.           node number in this and the DOUT[node#].DEF file to the same
  336.           value.
  337.  
  338.      NOTE: This file is created by RBBS when exiting to a door.
  339.  
  340.      2.   The DEFAULT security level given to the caller after
  341.           successfully completing the call back process. This is used
  342.           only if the security level configuration file does not exist,
  343.           OR the security level of the user has no corresponding entry
  344.           in the security level configuration file.  This can be just a
  345.           number, or a number with a plus sign "+" or minus sign "-".
  346.           If this parameter is set to a simple number then the door
  347.           will set the users security level to this number after
  348.           verifying the user. If the number has a "+" plus sign in
  349.           front of it, then the door will add this number to the users
  350.           security level.  If the number has a minus sign in front of
  351.           it, the door will subtract this number from the users
  352.           security level.
  353.  
  354.      3 .  The port address and IRQ number, separated by a colon, or for
  355.           Fossil Drivers the string "F:" followed by the port number.
  356.  
  357.      Example:  Standard ports:     02F8:3    for standard COM2
  358.                Fossil driver:      F:2       for FOSSIL on COM2
  359.  
  360.                NOTE: These port numbers are counting from 1.
  361.                Fossils count from 0 so if you list fossil STATUS it
  362.                will list COM2 as FOSSIL port 1!  Read the Fossil
  363.                documentation for more information.
  364.  
  365.  
  366.      NOTE:  It is recommended that you use a large buffer at least 1k
  367.      when the door is driving the serial port via a Fossil. If you have
  368.      memory to spare, use a 2k or larger buffer for the output buffer.
  369.      See the Fossil docs for info on command line parameters to set the
  370.      buffer size.
  371.  
  372.       4.   The complete path and filename of the RBBS DOUT[node#].DEF
  373.           file.
  374.      NOTE: This file is created by TCCB when TCCB exits to RBBS.
  375.  
  376.      5.   The string to send to your modem to get it to perform a
  377.           reset.
  378.  
  379.      NOTE: This is usually "ATZ".
  380.  
  381.      6.   The string to send to your modem to configure it.  This must
  382.           set up the modem to return the result codes ("CALL PROGRESS"
  383.           strings) that you specified in TCCB parameters 8 (BUSY) and 9
  384.           (CONNECT) as explained in this text.  The example shown has
  385.           the modem configured to return word result codes.  Numeric
  386.           result codes may also be used.  It does not matter as long as
  387.           the modem returns the same strings as specified in the batch
  388.           file configuration parameters 8 and 9.
  389.  
  390.      NOTE: Use "ATX4V1Q0" if unsure.
  391.  
  392.      7.   The dial command for your modem.
  393.  
  394.      NOTE: Usually "ATDT" for touch tone or "ATD" for pulse dialing.
  395.  
  396.      8.   The string(s) your modem sends when a call should be aborted
  397.           and re-dialed. This can be a mix of several strings, like
  398.           "BUSYNO DIALTONE", with no delimiters required. You might
  399.           include any string returned by your modem that should trigger
  400.           an abort and re-try of the call in progress. Some modems
  401.           return "VOICE", "NO CARRIER", "ERROR", and other strings.
  402.           It is entirely up to you which conditions should trigger a
  403.           re-try. If the modem returns one of these strings after
  404.           dialing, the door will abort the call in progress, reset
  405.           the modem and dial the number again up to 3 times before
  406.           giving up. In most cases "BUSY" alone will do just fine.
  407.  
  408.      NOTE: Usually "BUSY".  If you wish to use a string containing
  409.            spaces, you must put double quotes around the string in the
  410.            batch file.
  411.  
  412.      9.   The string your modem sends when it has made a connection.
  413.  
  414.      NOTE: Usually "CONNECT".  If you wish to use a string containing
  415.            one or more spaces, you must put double quotes around the
  416.            string.
  417.  
  418.                Example: "CONNECT 2400"
  419.  
  420.      10.  Long distance prefix. String to send before sending the area
  421.           code to accomplish a long distance call. Used when returning
  422.           long distance calls.  If this is set to a blank (a SPACE, or
  423.           " ") character then the door will not make long distance
  424.           calls.  To set to blank, use double quotes with ONE space, "
  425.           " , character inside.  This can be many characters, but if it
  426.           contains spaces it must be inside double quotes, "like this".
  427.  
  428.      NOTE: Usually a "1".
  429.  
  430.      11.  Lowest skipped security level.  A user is skipped (just
  431.           returned to the BBS without being called back or verified) if
  432.           his/her security level is equal to or greater then this
  433.           number. If you want all security levels to be verified then
  434.           set this to a number higher then the highest level attainable
  435.           by your users. When a user is skipped the door will assign
  436.           the (F)ail security level in the security level configuration
  437.           file if it exists.
  438.  
  439.  
  440.     *12.  Printer port. The printer is activated if this is a number
  441.           other then "0" zero. Enter 1 for LPT1, 2 for LPT2, and so
  442.           on... If this parameter is absent or "0" then the printer
  443.           will be turned off.
  444.  
  445.     *This is optional and may be left out of the command line.
  446.  
  447.      A "Standardized" version of the batch file is included with this
  448. package.  This file is configured as node #1, comm port COM2:, standard
  449. RBBS paths, NO long distance calls returned, levels above 9 are
  450. skipped.  The modem strings are for a standard Hayes compatible modem.
  451. The printer port parameter is "0" therefore the printer is turned off.
  452. This file will work on most RBBS systems with just a few changes.
  453.  
  454.  
  455.      Once you have unpacked the compressed file, created your batch
  456. file(s), and edited the .TXT/ANS and CFG files, you are done setting up
  457. the door.  Now run the RBBS utility "CONFIG" to set the path and name
  458. of your batch file (CALLBAK.BAT) using CONFIG option #107 (RBBS 17.3c).
  459. Next set the CONFIG option 108# to the highest security level to be
  460. processed by the door ON EVERY CALL.  This ensures that a caller that
  461. fails to be verified on the first call will trigger the verification
  462. process on every call until his/her security level gets raised
  463. (presumably by the door) to a level higher then option #108.  Make sure
  464. that the security level that the door assigns to a verified user is
  465. higher then this or RBBS will run the door every time a user calls!
  466. That's it you are done, TCCB is installed!  NOW TEST YOUR INSTALLATION.
  467. Have someone call and test every aspect of the doors operation
  468. including long distance operation.  REMEMBER:  Don't forget to set up
  469. the area codes file or disable long distance call-backs by entering a
  470. space as the long distance dialing prefix in the batch file!
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.                     The INSTALL utility for TCCB
  480.                     ----------------------------
  481.  
  482.  
  483.  
  484.       To make installation of TCCB as painless as possible, a TCCB
  485. batch file creation utility has been included in the distribution
  486. package. The program "INSTALL.COM", will make a new batch file for
  487. first time installation or modify an existing one.  INSTALL can be used
  488. to modify an existing batch file even if it contains many lines of
  489. commands.  INSTALL will search the file to find the line that runs TCCB
  490. and configures it.  If you have created multinode batch files to run
  491. TCCB on a multinode RBBS you can use INSTALL to modify your batch
  492. files.  INSTALL must be run in the same directory where the batch file
  493. exists. Install looks for a file with the name "CALLBAK.BAT" and uses
  494. it. If it does not find the file then it will create a new one.  After
  495. invoking INSTALL from the dos prompt, the program will display a list
  496. of 12 parameters. If INSTALL is modifying an existing file it will
  497. display the current parameters after each entry. Simply enter or modify
  498. each parameter until all 12 parameters are correct for your
  499. installation.  Enter a zero, "0", to exit the program. INSTALL will
  500. then offer to write the changes out or just exit without saving any
  501. changes.  Be sure to set up RBBS for a callback door by setting the
  502. RBBS "CONFIG" program options #107 and #108.
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.                           Files Used By TCCB
  511.                           ------------------
  512.  
  513.  
  514.  
  515.       Included with the package are seven text (.TXT) files, two log
  516. (.LOG) files, and seven ANSI type (.ANS) files.  The two .LOG files are
  517. the records of calls processed by the door. TCCB.LOG is a log of ALL
  518. calls processed by the door successful or not.  VERIFIED.LOG is a log
  519. of just the successfully verified calls. This is the file used by the
  520. door to detect and reject multiple registrations on one phone number.
  521. The .TXT and .ANS files are printed to the user during the operation of
  522. the door, and should be edited by the SysOp to customize them. Except
  523. for a few specific places, the door uses these text files for ALL
  524. output to the user.  This makes TCCB a completely configurable callback
  525. door.  The .ANS files should contain ANSI graphics.  The .TXT files
  526. should contain ONLY pure ASCII text.  The door will automatically
  527. detect the users configuration and print the appropriate .TXT or .ANS
  528. files.  If the user has graphics turned on in the BBS then the door
  529. will use the graphics (.ANS) files.  Otherwise it will print the .TXT
  530. files.  The door will provide "MORE" processing on text (.TXT) files.
  531. "MORE" processing is automatically turned off when in graphics mode.
  532. The door can be used with the files just as they are, but I am sure you
  533. can improve on them.  At least put the name of your BBS in
  534. CBINST.TXT/ANS, the opening instructions.  The names and contents of
  535. the .TXT/ANS files are as follows:
  536.  
  537.      - CBINST.TXT/ANS    Contains the opening instructions.
  538.  
  539.      - CBINS1.TXT/ANS    Contains instructions printed just before
  540.                          hanging up.
  541.  
  542.      - CBGUDNUM.TXT/ANS  Printed when a user has been verified and
  543.                          before returning to the BBS.
  544.  
  545.      - CBDUPNUM.TXT/ANS  Printed when a user is being rejected for
  546.                          attempting to register a previously verified
  547.                          number.
  548.  
  549.      - CBBDNM.TXT/ANS    Printed when the user fails to correctly
  550.                          enter his/her FULL name after being called
  551.                          back.
  552.  
  553.      - CBNOVFY.TXT/ANS   Printed when a users security level is equal
  554.                          to or greater then the "SKIP" user level and
  555.                          the door will just return to the BBS without
  556.                          performing a call back.
  557.  
  558.      - CBNOLD.TXT/ANS    Printed to Long Distance callers when the
  559.                          door is configured to refuse to call back
  560.                          long distance, the users area code is not in
  561.                          the configuration file, or there is a time
  562.                          limit that is not satisfied for the callers
  563.                          area code.
  564.  
  565.  
  566.  
  567.      The first of the two .LOG files is TCCB.LOG, the main log of all
  568. calls processed by the door. The second .LOG file is VERIFIED.LOG, this
  569. file contains ONLY numbers that have been successfully verified.  You
  570. can start out with these files empty or if you are upgrading from
  571. another RBBS callback door you can just copy the old log files from the
  572. other door into the TCCB log files.  It does not matter where the phone
  573. number appears on the line as long as there is just one phone number
  574. per line and each line is no more then 80 characters long.  TCCB will
  575. search the line to find the number. The phone number must be formatted
  576. with minus sign characters separating the area code and exchange from
  577. the body number (last four digits): XXX-XXX-XXXX
  578.  
  579.  
  580.      In addition to the .LOG and .TXT/ANS files there is the area code
  581. configuration file called "CBAREACD.CFG". If this file exists then the
  582. area codes contained in this file are the only area codes that the door
  583. will call back and only at preset times!  This feature of TCCB allows
  584. the sysop to verify (RETURN) only those long distance calls that are
  585. within a certain geographical area and only at a time when the long
  586. distance tolls are favorable. It also allows the sysop to configure the
  587. door to hang up after a long distance callback or allow the user to
  588. remain online. Each area code has it's own set of time and hangup
  589. control commands.  If the file does not exist then the selective
  590. callback feature is disabled, and the door will return calls to ANY
  591. area code!  NO error will be returned if the CFG file does not exist!
  592. If you wish to use this feature then you must make sure that the file
  593. is there.  (NOTE:  If you wish to disable ALL long distance call-backs,
  594. you simply put a space contained in double quotes in place of the long
  595. distance dialing prefix in the batch file.) The structure of the file
  596. is free form, except that there is just one area code to each line with
  597. one beginning time, one ending time, and one hangup control command.
  598. The area codes, times, and hangup command may appear anywhere on the
  599. line and be in any order. There must be no other information in the
  600. file.  Each line must be no more then 80 characters long.  The area
  601. code times and hangup commands are identified by a flag character just
  602. before the area code, time entry, or hangup command. This flag
  603. character may be in upper or lower case.  The times are just the hours
  604. in 24 hour format.  The hangup command is a zero or non zero number.
  605. If nonzero the door will hangup after completing the verification
  606. process. The flag character for area code is "A", therefore the area
  607. code "703" would appear as "A703" in the area code configuration file.
  608. The flag characters for the beginning and ending times are "B" and "E"
  609. respectively. The flag character for the hangup command is "H".  Here
  610. is an example line:
  611.  
  612. A909    E06     B14   H01
  613.  
  614. This line tells the door that it may call back area code 909, but only
  615. between the hours of 2:00 o'clock pm and 6:00 o'clock am and that it
  616. should hang up after the user has completed the verification process.
  617. As you can see the entry for 6:00 o'clock am is "E06" NOT "E6".  The
  618. reason for this is that the door expects to find an hours spec in 24
  619. hour (military) format, which is TWO numbers. The hangup command is
  620. simply an "H" with a zero or non zero number after it.  If the number
  621. following the hangup command is non zero then the door will hang up
  622. after a long distance callback to the area code on that line.  The area
  623. code, times, and hangup command must be separated by spaces.
  624.  
  625.  
  626.                      Local Area Code Configuration
  627.  
  628.      In addition to the long distance area codes in the area code
  629. configuration file, there is a provision for calling local phone
  630. numbers that require an area code sent in addition to the main number.
  631. If your dialing area does not require area codes to make a local call
  632. then you can ignore this feature. To set up the area code file to send
  633. the area code for a given local call, you must add the local area code
  634. to the configuration file but use "L" for the flag character instead of
  635. "A" for long distance area codes. An example line for local area code
  636. 909 is given below:
  637.  
  638.  L909
  639.  
  640. This line tells the door to dial the area code on a local call to area
  641. code 909. You may combine local and long distance area codes on the
  642. same line as long as there is just one local and one long distance
  643. area code on each line. If you have more then one local or long
  644. distance area code on a line then the door will ignore all but the
  645. first one. If you have local and long distance calls going to area
  646. code 909 you can make an entry like this:
  647.  
  648. A909 L909 B14 E06 H01
  649.  
  650. This line tells the door to send the area code on local calls to area
  651. code 909, and allow long distance callbacks to area code 909 if the
  652. call will take place between the times of 2:00 o'clock pm and 6:00
  653. o'clock am, and then to hang up after the callback.
  654.  
  655.      An example CFG file is provided with the package.  MAKE SURE TO
  656. EDIT OR DELETE THIS FILE!  Otherwise the door will return calls only to
  657. the area codes in the example file!  If you enter a quoted space where
  658. the long distance dialing prefix goes in the batch file then the door
  659. will NOT return long distance calls and will ignore the area code
  660. configuration file.
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.                    Security Level Configuration File
  670.                    ---------------------------------
  671.  
  672.  
  673.  
  674.      A new feature as of version 1.05 is the addition of a security
  675. level configuration file. This file (if it exists) controls the
  676. security level given to the user when the user exits from the door.
  677. This means that it even sets the users security level when the user
  678. fails to complete the verification process. The levels that the user
  679. gets are defined in the configuration file. There are three entries each
  680. with a flag character just like the area code configuration file.
  681. The flag characters are "E" for the users security level when she/he
  682. enters the door, "P" for the security level given when the user
  683. "PASSES" or completes the verification process, and "F" for the
  684. security level given to the user when he/she fails to complete the
  685. verification process. A line in the security level configuration file
  686. could look like this:
  687.  
  688. E5  P10  F3
  689.  
  690. This tells the door that a user coming into the door with a security
  691. level of 5, should go out with a security level of 10 if he/she
  692. successfully completes the verification process, or 3 if he/she fails to
  693. be verified. The two exit numbers could just as easily have had a plus
  694. sign or a minus sign to raise or lower the security level by that
  695. amount. In that case, the line above would look like this:
  696.  
  697. E5 P+10 F-3
  698.  
  699. This would raise the verified users level by 10, and lower the
  700. unverified users level by 3. This is a very powerful feature of TCCB,
  701. and can be used among other things to limit the number of times a user
  702. gets to run the door before being locked out. If the configuration file
  703. looked like this:
  704.  
  705.  
  706. E9 P10 F-1
  707. E8 P10 F-1
  708. E7 P10 F-1
  709. E6 P10 F-1
  710. E5 P10 F-1
  711. E4 P10 F-1
  712. E3 P10 F00
  713.  
  714.  
  715. This file will allow a user who starts out with a level of 9 to try
  716. the door 6 times and then if he fails on the 7th attempt he would be
  717. set to a security level of 0 and be locked out!
  718.  
  719.  
  720. This is just one of many things that can be done with this feature of
  721. TCCB. Other ideas include triggering questionnaires at different
  722. levels. This weeds out the "PROBLEM" users that can't make it through
  723. the door and need assistance. Also users who start out with different
  724. status on the system being set to a level that reflects that status
  725. after being processed through the door, like visiting sysops.
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.                             Printer Output
  735.                             --------------
  736.  
  737.  
  738.  
  739.      A new feature as of version 1.06 is printer support.  This
  740. feature, when activated, will send the TCCB.LOG file data to the
  741. standard BIOS printer device LPT1 or LPT2 etc. To activate the
  742. printer simply put the printer port number as the last parameter on the
  743. command line in the batch file. If this parameter is absent or is "0"
  744. then the printer will be deactivated (turned off). For LPT1 put a "1"
  745. in the last parameter of the batch file command line. For LPT2 put a
  746. "2" and so on...  If an error occurs while TCCB is sending data to the
  747. printer or the printer fails to respond within 30-40 seconds then the
  748. door will abandon sending data to the printer and return to normal
  749. operation after displaying "Printer error!" on the local console. This
  750. may cause a 30 to 40 second period during which TCCB will ignore
  751. input from both remote and local consoles. After 30 to 40 seconds TCCB
  752. will resume normal operation.
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.                            Sysop Functions
  763.                            ---------------
  764.  
  765.  
  766.  
  767.      TCCB has several features of interest to the sysop. These are
  768. available only from the local console.  They are activated by single
  769. hot keys. The functions and their respective hot keys are:
  770.  
  771.  
  772.           Shell to DOS                                <F5>
  773.           Prints a message to user then exits to dos. Type
  774.           "EXIT" to return to TCCB.
  775.  
  776.           Return user to system (Close Door)          <F8>
  777.  
  778.           Toggle display On or Off                    <F9>
  779.  
  780.           Chat mode                                   <F10>
  781.           Clears the screen and displays the sysop's and the
  782.           users typeout, allowing the sysop to chat with
  783.           the user. Time restrictions are NOT suspended while
  784.           in chat mode.
  785.  
  786.           Display status screen                       <ALT-H>
  787.           Toggles between status displays.
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.                         Errors Returned by TCCB
  799.                         -----------------------
  800.  
  801.  
  802.  
  803.      There are several fatal errors returned by TCCB. If you get one of
  804. these you have either got faulty hardware or you have not set up the
  805. batch file correctly. The errors are:
  806.  
  807.      Batch file configuration parameters missing!
  808.      --------------------------------------------
  809.      TCCB was executed with NO parameters. Bad batch file.
  810.  
  811.      Batch file has too few parameters!
  812.      ----------------------------------
  813.      The TCCB command line had less then 11 parameters.
  814.  
  815.      Batch file has too many parameters!
  816.      -----------------------------------
  817.      There were more then 12 parameters on the TCCB command line.
  818.  
  819.      Can't open DORINFO#.DEF!
  820.      ------------------------
  821.      Most likely the path to DOORINFO[node#].DEF is incorrect.
  822.  
  823.      While reading DORINFO#.DEF!
  824.      ---------------------------
  825.      A disk error has occurred wile reading DORINFO[node#].DEF
  826.  
  827.      DOUT#.DEF write error!
  828.      ----------------------
  829.      A disk error has occurred while TCCB was writing out the
  830.      DOUT[node#].DEF file.
  831.  
  832.      Can't open VERIFIED.LOG!
  833.      ------------------------
  834.      A disk error has occurred while accessing the VERIFIED.LOG file.
  835.  
  836.      Can't open TCCB.LOG!
  837.      --------------------
  838.      A disk error has occurred while accessing the TCCB.LOG file.
  839.  
  840.      Modem error during callback!
  841.      ----------------------------
  842.      The result string returned by your modem does not match the BUSY
  843.      or CONNECT strings specified in the batch file.
  844.  
  845.      Unsupported BBS type!
  846.      ---------------------
  847.      You should never get this error unless  you are trying to run the
  848.      door on  a BBS other  then RBBS. This  version of TCCB  will only
  849.      work with RBBS.
  850.  
  851.      Bad port specification, must be PORTADDR:IRQ# or F:PORT#!
  852.      ---------------------------------------------------------
  853.      Your port info in the batch file in incorrectly formatted.
  854.  
  855.      Fossil Driver NOT found!
  856.      ------------------------
  857.      The batch file is set up for a Fossil Driver when there is no
  858.      fossil driver loaded in memory.
  859.  
  860.      Can't allocate Memory!
  861.      ----------------------
  862.      A problem occurred while allocating memory.  You may need more
  863.      memory, or remove some memory resident programs and try again.
  864.  
  865.      Library error!
  866.      --------------
  867.      You should never get this error! If you get this error please
  868.      contact the authors for assistance.
  869.  
  870.      Corrupted executable!
  871.      ---------------------
  872.      The CB.EXE file has been corrupted. This could be due to disk
  873.      errors. Check your disk system. Unpack the CB.EXE file from the
  874.      distribution package again. If you still get this error, you
  875.      have a bad copy of TCCB. NOTE:  this could be due to a computer
  876.      virus attacking the CB.EXE file.
  877.  
  878.      Printer error!
  879.      --------------
  880.      The printer has been enabled but when TCCB attempted to send data
  881.      to it it got one of these errors:
  882.         1. Device timeout   (no response within 30-40 seconds)
  883.         2. Paper out
  884.         3. I/O error        (ports not configured correctly etc.)
  885.  
  886. If you have any problems installing the TCCB door, you may send a
  887. message to the sysop of Frostbyte Falls BBS at 703-425-6640.
  888.  
  889.  
  890.  
  891.  
  892.                              Author's Note
  893.                              -------------
  894.  
  895.  
  896.      Many hours of coding and debugging have gone into TCCB. In addition
  897. to the work of the authors, there have been contributions that deserve
  898. more than the mention that they get here. We would like to express our
  899. heartfelt thanks to the SysOps of the following BBSes who have helped
  900. to test and improve TCCB and make it what it is today.
  901.  
  902.  
  903.  
  904.        Joseph Aquino                           Jeff Alberts
  905.        SysOp of:                               SysOp of:
  906.        Ulysses Systems Network                 Helm's Deep
  907.        Rome, N. Y.                             Herndon, Va.
  908.        Main BETA test site                     First BETA test site
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.                    Other Things And Stuff We Forgot!
  917.                    ---------------------------------
  918.  
  919.  
  920.  
  921. Turbo C is a copyrighted product of Borland international.
  922. Turbo Assembler is a copyrighted product of Borland International.
  923. IBM is another word for ..
  924. Pascal is a language I don't know!
  925. My sweet pea has BLUE eyes (version 1.0).
  926. TCCB stands for T.... C Call Back (door)
  927. Now is the excellent foppery of the world that when we are sick in
  928. fortune.
  929. 1966 VW's with no rust and 175 HP engines are FUN!
  930. Some day I am going to put the cover back on my computer.
  931. THANK YOU!
  932.  
  933.  
  934.  
  935.  
  936.  
  937.